home *** CD-ROM | disk | FTP | other *** search
/ Risc World 3 / Risc World 3.iso / SOFTWARE / ISSUE2 / FASTERPC / !FASTERPC / !HELP / HELPTEXT < prev    next >
Text File  |  1994-08-08  |  12KB  |  268 lines
  1.  ******************  Copyright  Notice  ****************** 
  2.  *                                                       *
  3.  *  All program code is the copyright of David Lawrence  *
  4.  *                                                       *
  5.  *********************************************************
  6.  
  7.       Help file for !FasterPC V2.400 (08 August 1994)
  8.  
  9.  
  10.  This help file contains information about two specific
  11.  areas of !FasterPC.
  12.  
  13.  1. The operation of the configuration utility
  14.  
  15.  2. The potential error messages and their solutions
  16.  
  17.  The information supplied here is a resumé of the relevant
  18.  chapters of the User Guide and the reader is referred to
  19.  that document for full details.
  20.  
  21.  
  22.  —————————————————————————————————————————————————————————
  23.  1. !FasterPC Configuration
  24.  —————————————————————————————————————————————————————————
  25.  The !FasterPC configuration utility allows the user to
  26.  define and also create the number and size of PC 
  27.  Winchester partitions to be used with the application.
  28.  The configuration utility is only memory resident when
  29.  you request it. In order to maintain a seemless interface
  30.  with the main application, the configuration utility does
  31.  not install itself on the icon bar, but only exists as a
  32.  window on the desktop. When you have finished with it,
  33.  close its window and the utility will terminate.
  34.  
  35.  —————————————————————————————————————————————————————————
  36.  Starting the Configuration Utility
  37.  —————————————————————————————————————————————————————————
  38.  To start the configuration utility open the !FasterPC
  39.  icon bar menu and select the 'Config...' option. Once 
  40.  started, the utility will open its only window but will
  41.  not install itself on the icon bar.
  42.  
  43.  —————————————————————————————————————————————————————————
  44.  The Configuration Utility Window
  45.  —————————————————————————————————————————————————————————
  46.  The configuration utilities window has deliberately been
  47.  designed to look similar to the hard disc file section of
  48.  Acorn's !PCem configuration window. This is for the
  49.  convenience of users of both applications.
  50.  
  51.  —————————————————————————————————————————————————————————
  52.  Number of Configured Hard Disc Drives
  53.  —————————————————————————————————————————————————————————
  54.  The number after the 'Hard disc drive files:' heading
  55.  indicates how many of the drive files listed in the boxes
  56.  below it will be included in the configuration file if
  57.  the save button is pressed. To increase the number of
  58.  hard disc drive files, click on the number with the
  59.  select button. The maximum number of drive files is four.
  60.  To decrease the number, click with the adjust button. The
  61.  minimum number of hard drive files if zero, i.e. you
  62.  would be emulating an IBM PC with only a floppy drive.
  63.  Each row in the dark grey box below the number of hard
  64.  disc drive files refers to a PC Winchester partition.
  65.  
  66.  —————————————————————————————————————————————————————————
  67.  Referencing an Existing Winchester Partition
  68.  —————————————————————————————————————————————————————————
  69.  To include an existing partition in the configuration,
  70.  either type its full path name into the central white
  71.  icon or drag its icon from a filer directory window onto
  72.  the central white icon and drop it there. The icon will
  73.  immediately change to display the full path name of the
  74.  file that you have dropped and the following icon will
  75.  display the file's size in megabytes. Note that the file
  76.  type of the file that you drag and drop in this way must
  77.  be DOSDisc (file type &FC8). If it is not, then the
  78.  configuration utility will reject the file and display an
  79.  error message.
  80.  
  81.  —————————————————————————————————————————————————————————
  82.  Creating a New Partition
  83.  —————————————————————————————————————————————————————————
  84.  To create a new disc partition, you must type the full
  85.  path and file name of the partition file into one of the 
  86.  central white icons. Once this is done, you have to set
  87.  the desired size of the file by clicking on the white 
  88.  icon next to the path name that you have just entered and
  89.  typing the required file size, in megabytes. This then
  90.  defines the file's location and size. Clicking on the
  91.  create icon to the left of the partition file name will 
  92.  cause the configuration utility to actually create the
  93.  file. Note that an error will be reported and the file
  94.  will not be created if a file of the same path/name
  95.  already exists, or if the current directory structure
  96.  does not match your requested location, or if the utility
  97.  is unable to access the disc or directory that you have
  98.  specified, or if there is insufficient disc space left to
  99.  hold your file.
  100.  
  101.  —————————————————————————————————————————————————————————
  102.  Saving the Configuration
  103.  —————————————————————————————————————————————————————————
  104.  Once the configuration window is set up to your
  105.  satisfaction, clicking on the save icon causes the
  106.  configuration utility to check your settings, to see if
  107.  you have asked for more drives than you have defined
  108.  paths/files for. If everything appears to be correct, the
  109.  configuration utility performs three actions:
  110.  
  111.  • saves your settings in the file 'Drives' in !FasterPC's
  112.    'resources' directory
  113.  • obeys the file 'Drives', setting the system variables
  114.    to their new values
  115.  • sends a message to !FasterPC, telling it that the
  116.    configuration has been changed
  117.  
  118.  Clicking on the set icon causes the system variables to
  119.  be set and sends a message to !FasterPC, as above, but
  120.  does not modify the Drives file. This allows the user
  121.  to temporarily modify the selected partitions.
  122.  
  123.  The disc partitions created by the configuration utility
  124.  are ready for partitioning and formatting using the
  125.  standard MS DOS utilities FDISK.EXE and FORMAT.COM.
  126.  
  127.  —————————————————————————————————————————————————————————
  128.  Quitting the Configuration Utility
  129.  —————————————————————————————————————————————————————————
  130.  To quit the configuration utility, click on the close
  131.  window icon on the window's title bar. The utility will 
  132.  quit and its window will disappear.
  133.  
  134.  
  135.  —————————————————————————————————————————————————————————
  136.  2. !FasterPC's Error Messages
  137.  —————————————————————————————————————————————————————————
  138.  There now follows a list of the possible error messages
  139.  that !FasterPC can detect. Each listed error has a
  140.  section describing the conditions that can cause the
  141.  error and also a section giving some hints on how to
  142.  avoid the error.
  143.  
  144.  —————————————————————————————————————————————————————————
  145.  Illegal or unsupported opcode detected
  146.  —————————————————————————————————————————————————————————
  147.  !FasterPC has tried to execute either an unimplemented
  148.  8086 or 80186 instruction, non-executable data, or an
  149.  instruction for an 80286 or higher processor.
  150.  
  151.  If you have not enabled the 80186 option on !FasterPC's
  152.  icon bar menu then enable it and try your PC program
  153.  again. If the fault is still present then check the
  154.  documentation associated with the program and ensure
  155.  that it should run on an 8086 (IBM PC XT or compatible).
  156.  If this is the case you could contact me following the
  157.  guidelines mentioned below for an investigation.
  158.  
  159.  —————————————————————————————————————————————————————————
  160.  Attempt to change to an unsupported video mode detected
  161.  —————————————————————————————————————————————————————————
  162.  The PC software that you are running has tried to switch
  163.  to a video mode that is not supported by !FasterPC in
  164.  its current configuration. This may be because the
  165.  software does not check whether the required video
  166.  adaptor is present before performing the mode change,
  167.  or because you have an adaptor enabled that is not fully
  168.  supported (EGA, VGA or Tandy).
  169.  
  170.  Try disabling any optional video adaptors, one at a time,
  171.  and re-running the PC program to see if the problem has
  172.  gone away. If this fails, try enabling the video override
  173.  option (if present) in the display submenu to see if this
  174.  will solve your problem.
  175.  
  176.  —————————————————————————————————————————————————————————
  177.  Unsupported palette function detected
  178.  —————————————————————————————————————————————————————————
  179.  The PC software that you are running has tried to use an
  180.  unsupported VGA palette function. It thinks that this can
  181.  be done as you have enabled the VGA adaptor and not all
  182.  of the palette functions are implemented. This should be
  183.  quite a rare error as the majority of BIOS palette calls
  184.  are to do with reprogramming the palette, and these calls
  185.  are fully implemented.
  186.  
  187.  Try disabling the VGA (and also possibly the EGA) adaptor
  188.  to see if your program will run in another video mode.
  189.  
  190.  —————————————————————————————————————————————————————————
  191.  The Emulator is trying to execute jump vectors
  192.  —————————————————————————————————————————————————————————
  193.  For some reason, !FasterPC is executing code that is in
  194.  the 8086 jump vectors (RAM locations 00000h to 00400h).
  195.  This is probably because it has become confused and mis-
  196.  interpreted a previous instruction.
  197.  
  198.  Try running your program several times to see if the
  199.  problem always occurs and whether is always occurs at
  200.  the same place. If this is the case, the problem is
  201.  repeatable, and you might like to contact me following
  202.  the guidelines mentioned below for an investigation.
  203.  
  204.  —————————————————————————————————————————————————————————
  205.  Unable to change to required FasterPC screen mode
  206.  —————————————————————————————————————————————————————————
  207.  This error is reported when !FasterPC has been unable
  208.  to change to one of its special screen modes. These
  209.  modes are supported by the VGAmodes module present in
  210.  the application directory, and RMLoaded when the
  211.  application is started. It is possible that you do not
  212.  have sufficient memory available for the VGA screen modes
  213.  before trying to run the emulator. !FasterPC requires
  214.  80k bytes of screen memory to run in 50Hz mode and 300k
  215.  to run in VGA mode.
  216.  
  217.  Open the task window and drag the coloured bar
  218.  representing the screen memory until it is at least 80k
  219.  or 300k as required and try again.
  220.  
  221.  —————————————————————————————————————————————————————————
  222.  User forced exit from !FasterPC
  223.  —————————————————————————————————————————————————————————
  224.  This error is reported if the user performs a forced exit
  225.  from !FasterPC by using the two Alt keys and mouse menu
  226.  button mechanism. This exit is provided to allow crashed
  227.  or 'difficult' DOS programs to be exitted. The normal
  228.  exit, left Alt key and mouse menu button is to be
  229.  preferred if it works.
  230.  
  231.  This message is more of a warning message rather than an
  232.  error. If a DOS program repeatedly causes you to have to
  233.  use this exit mechanism, you  might like to contact me
  234.  following the guidelines mentioned below for an
  235.  investigation.
  236.  
  237.  —————————————————————————————————————————————————————————
  238.  An unknown error has occurred
  239.  —————————————————————————————————————————————————————————
  240.  This error is reported if !FasterPC exits without a valid
  241.  reason code. This is a 'catch all' error handler and the
  242.  author has never seen this error reported during the
  243.  development period.
  244.  
  245.  If you get this error and are able to repeat it, you
  246.  might like to contact me following the guidelines
  247.  mentioned below for an investigation.
  248.  
  249.  —————————————————————————————————————————————————————————
  250.  Reporting errors for investigation
  251.  —————————————————————————————————————————————————————————
  252.  The occasion may occur when you are unable to correct a
  253.  possible fault with !FasterPC and some PC software that
  254.  you are trying to run. Refer to the section in the User
  255.  Guide, chapter 'Errors and Solutions' for the procedure
  256.  to be followed to get your problem investigated.
  257.  
  258.  
  259.                           To contact the author, write to:
  260.  
  261.                                            D. J. Lawrence,
  262.                                            33 High Street,
  263.                                            Farnborough,
  264.                                            Hampshire
  265.                                            GU14 6ES
  266.                                            United Kingdom
  267.  
  268.